Take the following steps to install and test WebSite. These steps are explained
fully in the next sections.
<OL>
<LI>Complete the WebSite Installation Requirements checklist.
<P>
<LI>Start the WebSite Setup utility by selecting Run from the File menu. You must
be logged in as a member of the Administrators or Backup group if you plan
to install WebSite as a service under Windows NT.
<P>
<LI>Press Install on the first setup dialog.
<P>
<LI>Specify the destination directory for WebSite (the default is C:\WEBSITE).
<P>
<LI>Enter the Fully Qualified Domain Name for the server
<P>
<LI>Enter the Internet email address of the WebSite server adminstrator (does not
need to be the system administrator).
<P>
<LI>If you have an existing web document structure, provide the full pathname
for the document root.
<P>
<LI>If your existing web document structure uses a name other than index.html
for its directory index files, enter the actual name.
<P>
<LI>Test the server's operation from the local computer.
<P>
<LI>Test the server's operation from a remote computer.
<P>
<LI>Review the General property sheet page of Server Admin.
<P>
<LI>Activate the WebSite server administrator account.
<P>
<LI>Install WebSite as a service (optional for Windows NT only).
</OL>
<H2>Installing the WebSite Software</H2>
<p>
<blockquote>
<b>Note:</b>
The installation instructions that follow were written for the 2-disk
full WebSite product. If your demonstration version uses different
media (say, a CD-ROM or a downloaded ZIP file), please adapt the
instructions for those media.
</blockquote>
<p>
WebSite comes on two 3.5" disks, which include the WebSite Server and Server
Admin software; the WebSite applications WebView, Image Map Editor, and
WebIndex; a copy of Enhanced NCSA Mosaic; and the WebSite server self test
and other web documents. These components are all installed by the WebSite
Setup Utility.
<P>
To install WebSite, complete these steps:
<OL>
<LI>Start your computer and log on to Windows NT or Windows 95. If you are
installing WebSite as a service, you must be a member of either the Administrator or Backup groups.
<P>
<LI>Insert Disk 1 into the first 3.5" drive (either A or B) on your system.
<P>
<LI>Select Run from the File menu.
<P>
<LI>Type <I>a:\setup</I> (or <I>b:\setup</I>) and press OK.
<P>
<LI>Press Install on the WebSite Setup Utility window. (See Figure 2-1.)
<P>
<HR>
<I>Figure 2-1: WebSite Setup utility</I>
<P>
<IMG SRC="figs/ws_02_01.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>Accept or change the default installation path in the Installation Directory
window. The default is C:\WEBSITE. (See Figure 2-2.)
<P>
<HR>
<I>Figure 2-2: Path for WebSite</I>
<P>
<IMG SRC="figs/ws_02_02.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>Enter the Fully Qualified Domain Name in the first field of the Server Configuration window. In Figure 2-3 we have entered the FQDN for the computer
used in writing this book.
<P>
<LI>Enter the <I>full</I> Internet email address of the WebSite server administrator in the
second field. WebSite uses this name and address for creating mailto URLs in
automatic directory indexes (see Chapter 9). The email address can be <I>any</I>
Internet address, not necessarily an address on the computer on which you
are installing WebSite. For example, you may want the email sent to your
regular email address, as shown in Figure 2-3.
<P>
<HR>
<I>Figure 2-3: FQDN and email address of WebSite administrator</I>
<P>
<IMG SRC="figs/ws_02_03.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>If you <I>don't</I> have a web on your computer, accept the defaults for the document root and home page in the Home Page window. (See Figure 2-4.)
<P>
<HR>
<I>Figure 2-4: WebSite document path and index file name</I>
<P>
<IMG SRC="figs/ws_02_04.gif" ALT="(IMAGE)">
<HR>
<P>
If you have an existing web on your computer that you wish to manage with
WebSite, you must tell Setup its root directory (the document root) and the
name used for index or home pages. Let's say your existing web document
root directory is C:\MYWEB. Replace the path HTDOCS with the absolute
path C:\MYWEB. WebSite uses the new path to find documents on your
server. For an in-depth discussion of mapping, see Chapter 8.
<P>
If you use a different name for your web's directory indexes, you must
change the default. <I>index.html</I> is a standard name, but you may be using
another name such as <I>default.html</I> or <I>home.html</I>. Or you may be using a web
created in the Windows/DOS environment which does not support long filenames. In that case, the index name may be <I>index.htm</I>. WebSite uses the
index name when a browser requests a URL that doesn't include a filename; if
this file doesn't exist for the URL path, the server creates an automatic directory index. You can also change this name later in Server Admin. For an
in-depth discussion of automatic directory indexing, see Chapter 9.
<P>
<LI>Insert Disk 2 when prompted. As the installation finishes, one or two
Command Windows may open and close on your screen. This is a normal
part of setup. When Setup is complete, a final dialog appears with some
suggestions for what to do next with your WebSite server (Figure 2-5). Press
OK to close Setup.
<P>
<HR>
<I>Figure 2-5: WebSite installation complete</I>
<P>
<IMG SRC="figs/ws_02_05.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>On exiting Setup, the WebSite server is launched as a desktop icon, and the
WebSite program group is displayed on your desktop. Figure 2-6 shows the
Program Group for Windows NT. The desktop for Windows 95 may vary
slightly, but the WebSite icons are the same.
<HR>
<I>Figure 2-6: WebSite program group for Windows NT</I>
<P>
<IMG SRC="figs/ws_02_06.gif" ALT="(IMAGE)">
<HR>
</OL>
<blockquote>
<B>Note</B>
<BR>
If you want the server to start automatically when you log in, move the
WebSite Server icon to your startup group.
<P>
To run WebSite as a service, first test the server and then follow the instructions later in this chapter for installing WebSite as a service.
</blockquote>
<H2>
Testing the WebSite Server
</H2>
After installing WebSite, you must test the server to verify that it is installed and
operating properly. The verification test has three parts:
<UL>
<LI>
Making sure the server is running
<P>
<LI>
Viewing a WebSite document from the local computer
<P>
<LI>
Viewing a WebSite document from a remote computer
</UL>
<H3>Is the Server Running?
</H3>
When you exit the Setup utility, the WebSite server is launched and minimized to
a desktop icon (Figure 2-7). If you can see the icon on your screen, then the
server has passed the first test-it's running. The icon title indicates the server's
status as <I>idle</I> or <I>busy</I>.
<P>
<HR>
<I>Figure 2-7: WebSite server icon (idle status)</I>
<P>
<IMG SRC="figs/ws_02_07.gif" ALT="(IMAGE)">
<HR>
<P>
To become familiar with the WebSite components, double-click on the WebSite
icon to display the WebSite Server window (Figure 2-8). The only action you can
execute from the Control menu is to exit the server. Generally you will want to
display the server as a desktop icon.
<P>
<HR>
<I>Figure 2-8: WebSite server window</I>
<P>
<IMG SRC="figs/ws_02_08.gif" ALT="(IMAGE)">
<HR>
<H3>
Can You View a WebSite Document from the Local Computer?
</H3>
The easiest way to test if your computer and WebSite are set up correctly is to
launch a web browser (for example, EMosaic in the WebSite program group) and
specify the URL for your server. We'll discuss the browser and URLs in more
detail in Chapter 3; for now, just follow these steps:
<OL>
<LI>Make sure your WebSite server is running (the icon is visible on the desktop).
<P>
<LI>Make sure your TCP/IP connection is open. If you are on a TCP/IP network
or have a dedicated connection to the Internet, this is probably transparent to
you. If you are on a standalone computer and get your TCP/IP connectivity
with a dial-up SLIP or PPP account, make sure that the connection is up and
clear. The WebSite server and browser require an open TCP/IP socket to
work.
<P>
<LI>Double-click on the Read Me First icon in the WebSite program group. This
icon launches Mosaic and displays the ReadMe file, as shown in Figure 2-9.
However, displaying this document does not verify that the server is working
because the browser did not find it by contacting the server. (You can see the
file's pathname in the URL field.)
<P>
<HR>
<I>Figure 2-9: WebSite ReadMe File</I>
<P>
<IMG SRC="figs/ws_02_09.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>Click on the hypertext link <I>home page</I>. The link is for the URL
<blockquote>
<pre>
http://localhost/
</pre>
</blockquote>
The browser sends out the request for this URL, which is interpreted by the
browser and server as the home page file on the local computer. (Note that
using <I>localhost</I> in a URL won't work when you try to reach your server from
another computer.)
<P>
If the server and computer are set up correctly, the temporary WebSite home
page appears in the browser window, as shown in Figure 2-10.
<P>
<HR>
<I>Figure 2-10: Default WebSite home page as shown by Mosaic</I>
<P>
<IMG SRC="figs/ws_02_10.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>Next, test the server using the IP address. Select Open URL from the Mosaic
File menu. Type in the URL for your server, using the following format:
<blockquote>
<pre>
http://<I>your.IP.address</I>/
</pre>
</blockquote>
where <I>your.IP.address</I> is the IP address of your server, such as
198.112.209.138. Don't forget the final slash. The browser should display the
same document as shown in Figure 2-10, except that the URL field displays
the server's IP address rather than localhost.
<P>
<LI>If your server's domain name is registered with DNS, test the server using the
domain name. Type in the URL for your server, using the following format:
<blockquote>
<pre>
http://<I>your.server.name</I>/
</pre>
</blockquote>
where <I>your.server.name</I> is the fully qualified domain name (FQDN) of your
server, such as <I>happy.dopey.com</I>. The browser should display the document
shown in Figure 2-10, except that the URL field displays the server's name
rather than <I>localhost</I>.
</OL>
<H3>
Can You View a WebSite Document from Another Computer?
</H3>
The next step in testing the server is to view a document on your WebSite server
from a different computer, either one on your internal network or one connected
to the Internet. To complete this test you must have access to another computer
that has a Web browser. Obviously, if that computer is one on your network, it
must also be configured for TCP/IP.
<P>
To test the WebSite server from another computer, follow these steps:
<OL>
<LI>Make sure your WebSite server is running.
<P>
<LI>Make sure your computer's TCP/IP connection is open.
<P>
<LI>From the other computer, launch a Web browser such as Mosaic.
<P>
<LI>Specify the URL for your server, using the following format:
<blockquote>
<pre>
http://your.IP.address/
</pre>
</blockquote>
where <I>your.IP.address</I> is the IP address of your server. Don't forget the final
slash. The browser uses the URL to locate your WebSite server. If everything
is set up correctly, you will see the WebSite default home page (Figure 2-10).
<P>
<LI>If your server's domain name is registered with DNS, test the server by specifying the URL again, using the following format:
<blockquote>
<pre>
http://your.server.name/
</pre>
</blockquote>
where <I>your.server.name</I> is the fully qualified domain name (FQDN) of your
server. Don't forget the final slash. If everything is set up correctly, you will
see the WebSite default home page (Figure 2-10).
</OL>
If you performed this test from a computer on your local network and it does not
work, make sure the server is running and then check the TCP/IP configuration of
the computer and the network. If you continue to have difficulties, consult your
network or system administrator.
<P>
If you conducted this test from a computer connected to the Internet and it failed,
try again. Sometimes heavy traffic on the Internet can cause connections to
time out. If after several tries you still cannot reach the server, recheck the TCP/IP
connections on both computers. Also make sure your server's name is a fully qualified domain name and that it is registered with DNS. If you continue to have difficulties, consult your Internet service provider.
<H2>
Reviewing WebSite's General Setup
</H2>
During installation, the WebSite Setup utility puts specific information about your
server in the Server Admin application. We will deal with many of these topics in
great detail in Section 3 of this book, but for now, let's take a look at the most
general information. You may need to make changes to the general setup at some
point, and this will acquaint you with the particulars. Also, if you choose to run
WebSite as a service, you need to make that change here.
<P>
To view the general information, launch the Server Admin icon from the WebSite
program group. The General property sheet page is displayed, as shown in
Figure 2-11.
<P>
<HR>
<I>Figure 2-11: Server Admin General page</I>
<P>
<IMG SRC="figs/ws_02_11.gif" ALT="(IMAGE)">
<HR>
<P>
The top of the page provides information about your WebSite server:
<DL>
<DT><B>Working Directory</B>
<DD>
Indicates where WebSite is installed. This directory is also called the server
root. We discuss this concept in detail in Chapter 8.
<P>
<DT><B>Administrator Address</B>
<DD>
Shows the complete email address of the WebSite server administrator. Notice
that the address is the Internet address you entered during setup. You can
change the address here by typing in a new one.
<P>
<DT><B>Run Mode</B>
<DD>
Specifies how WebSite will run the next time it is started. For Windows NT,
the pull-down field has three choices: desktop application, system service
with icon, and system service without icon. If you want to run WebSite as a
service, you must first select a new run mode here and then restart the server
as a service. Under Windows 95, you cannot run WebSite as a service, so
Run Mode is dimmed and fixed at desktop application.
</DL>
The rest of the page provides information about your WebSite server's network
connections:
<DL>
<DT><B>Server Name</B>
<DD>
Shows the fully qualified domain name (FQDN) of the server, which you
entered during setup. The server's FQDN is not necessarily the same as the
computer's name.
<P>
<DT><B>TCP/IP Port</B>
<DD>
Tells the server what port number to use. The standard TCP/IP port is 80.
Unless you know what you are doing, don't change this number.
<P>
<DT><B>Timeouts (Receive and Send)</B>
<DD>
Fairly standard settings. You may need to increase the timeouts if you are on
a slow link, or if users complain that your server seems ``slow'' or ``cuts off''
documents. Increase the timeouts to 60 seconds for a PPP/SLIP connection.
<DT><B>Winsock Vendor Information</B>
<DD>
Lists the valid Winsock programs detected on your system. WebSite uses
Microsoft's Winsock Version 1.1. You cannot change this field.
</DL>
As you can see, much of the information on this page is rarely changed.
However, if you have a problem with the server, technical support may ask you
to change some of the values on this screen.
<blockquote>
<B>Warning</B>
<BR>
When you make a change to Server Admin, it does not take effect until
you close the program. A few seconds after you close it, you will hear the
computer beep, indicating that the server's configuration has been updated. If the server is not running, you will not hear a beep, but the configuration is in effect the next time you start the server.
</blockquote>
<H2>
Activating the Administrator Account
</H2>
WebSite comes with a default user account called <I>Admin</I>. This account is
dormant, meaning it has no password and belongs to no groups. To activate the
account you must assign a password and add it to at least one group. The <I>Admin</I>
account is useful for restricting certain URLs and server functions to a single
account and for remotely administering WebSite (see Appendix C for more information on remote administration).
<P>
To activate the administrator account, you must first select a password. Then
complete these steps:
<OL>
<LI>Launch the Server Admin icon from the WebSite program group and click on
the tab for the Users page (Figure 2-12).
<P>
<HR>
<I>Figure 2-12: Server Admin Users page</I>
<P>
<IMG SRC="figs/ws_02_12.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>In the Users field, display the user <I>Admin</I> (as shown) and click on the Password button. The change password dialog appears (Figure 2-13).
<P>
<LI>Since there is no old password, put the cursor in the New Password field and
type in the new password. Press TAB and type in the new password again.
The password is hidden as shown in Figure 2-13. Press OK when finished.
<P>
<HR>
<I>Figure 2-13: Change password for User dialog</I>
<P>
<IMG SRC="figs/ws_02_13.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>In the Group Membership section of the property sheet, highlight Administrators and press Add. Repeat for Users. (You can accomplish the same task by
double-clicking on the group name.) Figure 2-14 shows this section after the
group memberships are assigned.
<P>
<HR>
<I>Figure 2-14: Adding Users to Groups</I>
<P>
<IMG SRC="figs/ws_02_14.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>Press OK to update the server and finish the activation. If the server is
running, wait for it to beep before trying to use the new account.
</OL>
<H2>
Installing WebSite as a Service
</H2>
To run WebSite as a service rather than a desktop application under Windows NT
requires only a few quick steps. All the information the operating system needs is
in place-you simply have to shut down the server as an application and start it
up again as a service.
<P>
Complete the following steps to run WebSite as a service under Windows NT:
<OL>
<LI>Exit the WebSite server if it is running.
<P>
<LI>On the General property sheet page of Server Admin, change the server's Run
Mode from Desktop Application to System Service, either with or without an
icon. (See Figure 2-11.)
<P>
<LI>In the Windows NT Control Panel, open the Services program item.
<P>
<LI>Scroll through the listed services until you come to Web Server, as shown in
Figure 2-15.
<P>
<HR>
<I>Figure 2-15: Windows NT Services window</I>
<P>
<IMG SRC="figs/ws_02_15.gif" ALT="(IMAGE)">
<HR>
<P>
<LI>Highlight Web Server and press Start.
<P>
<LI>If you want WebSite to start automatically whenever the system starts, press
Startup on the Services window and complete the necessary information.
Refer to the operating system guide for more help in setting up services.
</OL>
<blockquote>
<B>Note</B>
<BR>
To return WebSite to a desktop application, simply stop the service, reset
the Run Mode in Server Admin, and launch the server as an application.
</blockquote>
<H2>For More Help</H2>
Several sources of help are available to WebSite users, including:
<UL>
<LI>
This book, <I>Building Your Own WebSite</I>
<P>
<LI>
WebSite Online Help
<P>
<LI>
WebSite Central (<I>http://website.ora.com/</I>)
<P>
<LI>
WebSite Technical Support
</UL>
<H3>
Getting the Most out of this Book
</H3>
<I>Building Your Own WebSite</I> provides comprehensive instructions
for installing
and using the various applications and tools that make up WebSite. This book
takes a task-oriented approach, presenting as much procedural material as
possible in a real-life, hands-on manner. The numerous tutorials give you an
opportunity to practice the skills you need for building and maintaining a
successful web. We encourage you to work through the tutorials and apply the
steps to your own specific web.
<P>
In addition, we've included scenarios for how your web can be more practical
and useful to others. Helpful hints, ideas for using the server, and notes for
avoiding difficulties are scattered throughout the book. And don't overlook the
appendices, which include valuable reference and troubleshooting material. For
example, if you're having problems with WebSite, first consult Appendix D.
<H3>
Using Online Help
</H3>
Each WebSite application has online help available through either a menu item or
a screen button. In addition, you can bring up the help system by pressing F1 in
any window.
<P>
The WebSite online help gives definitions and specific procedures regarding the
current application. As in online help for other Windows-based applications,
WebSite help includes hyperlinks to associated topics and topic searching.
<H3>
Joining WebSite Central
</H3>
Perhaps the most exciting and bountiful source of help and further information is
WebSite Central, a WebSite maintained for WebSite users by the technical support
staff of O'Reilly & Associates. WebSite Central provides product information,
answers to frequently asked questions (FAQs), troubleshooting help, advice for
particular implementations of WebSite, ideas for new uses of WebSite, sample
HTML files, helpful utility programs, and opportunities to interact with the technical support staff and other WebSite users.
<P>
Because WebSite Central is part of the World Wide Web, the information is
constantly updated and enhanced. You can register your WebSite with WebSite
Central and increase your server traffic. From time to time, WebSite Central administrators will check out member webs and present awards to particularly
well-implemented or useful locations. You'll want to check WebSite Central often to
see what's new for WebSite users.
<P>
Joining WebSite Central is simple. On the WebSite ReadMe page you saw when
testing your server is a link to the registration form. Once you submit the registration, another link takes you to WebSite Central.
The WebSite Central URL is <I>http://website.ora.com/</I>.
You'll know you're at the right place when you see the WebSite
Central logo (Figure 2-16).
<P>
<HR>
<I>Figure 2-16: WebSite Central Logo</I>
<P>
<IMG SRC="figs/ws_02_16.gif" ALT="(IMAGE)">
<HR>
<H3>
Contacting Technical Support
</H3>
Demonstration versions do not include techincal support.
The full WebSite product includes 90 days free technical support by
